home *** CD-ROM | disk | FTP | other *** search
/ Magnum One / Magnum One (Mid-American Digital) (Disc Manufacturing).iso / d11 / warpdrv.arc / WARP.DOC < prev    next >
Text File  |  1991-04-06  |  9KB  |  195 lines
  1.  
  2.  
  3.  
  4.                                    Warp Driver
  5.  
  6.                                        by
  7.  
  8.                                    Eric Tauck
  9.                                1304 Deerpass Road
  10.                                 Marengo, IL 60152
  11.                                      U.S.A.
  12.  
  13.                              Compuserve: 72457,1557
  14.                        Internet: 72457.1557@compuserve.com
  15.  
  16.         Warp is a device driver for speeding up standard output.  Addi-
  17.         tional features of Warp include auto-pause, a shortened BIOS
  18.         beep, and partial ANSI support.  Warp requires a PC/XT/AT compat-
  19.         ible and DOS 2.0 or higher.
  20.  
  21.         There are three flavors of Warp, WARP.SYS, WARPF.SYS, and
  22.         WARPVF.SYS.  WARP.SYS is the most compatible but slowest, while
  23.         WARPVF.SYS is the least compatible but the fastest (the 'F' in
  24.         WARPF.SYS stands for fast and the 'VF' in WARPVF.SYS stand for
  25.         very fast).  Both WARPF.SYS and WARPVF.SYS use the undocumented
  26.         but standard PUTCHAR function (interrupt 29H).  Additionally,
  27.         WARPVF.SYS updates the hardware cursor only when necessary.  With
  28.         WARPVF.SYS, the cursor may be in odd locations during DOS opera-
  29.         tions, but should be moved to the correct location by the time
  30.         input is expected.  I recommend trying all three drivers to
  31.         determine which is most suitable for your system.
  32.  
  33.         Warp is installed in the CONFIG.SYS file:
  34.  
  35.           DEVICE=WARP.SYS [options]
  36.  
  37.         The possible options are:
  38.  
  39.           /C:x  Set the initial output color to x.  This value is an
  40.                 attribute byte in the range 0 to 255.  You need to look
  41.                 up the color values in a technical reference to set the
  42.                 output color in this manner.  You can also set the color
  43.                 with an ANSI sequence documented below.
  44.  
  45.           /S    Disable auto-pause.
  46.  
  47.           /S:x  Set auto-pause to x lines.
  48.  
  49.         The auto-pause feature works something like the MORE utility
  50.         included with DOS.  Whenever a specified number of lines have
  51.         been displayed, the message "Press any key to continue ..." is
  52.         displayed at the bottom of the screen and Warp waits for a key to
  53.         be pressed.  The auto-pause feature is enabled whenever scroll-
  54.         lock is active.  A screen can also be un-paused by turning off
  55.         scroll-lock.  By default, Warp will pause the screen after a
  56.         single page of lines, however, auto-pause can be set to a specif-
  57.         ic number of lines or totally disabled with the /S option.  Note
  58.         that Warp starts counting lines sent to the CON device after any
  59.  
  60.  
  61.  
  62.         input and will pause no matter what's being executed.  If you
  63.         plan on running a program unattended that sends its output to the
  64.         standard output device (CON), make sure you disable auto-pause or
  65.         turn scroll-lock off.
  66.  
  67.         Warp automatically generates a shorter and less annoying beep
  68.         than produced by DOS or BIOS.  This is done by hooking interrupt
  69.         10H and trapping all ASCII code 7's sent to the BIOS TTY func-
  70.         tion.  Only a few, mostly older, applications will be affected by
  71.         this.
  72.  
  73.         Warp's ANSI support is limited to clear screen, move cursor, and
  74.         set color.  The exact ANSI sequences supported are as follows:
  75.  
  76.           ESC[2J            clear screen
  77.           ESC[#;#f          move cursor
  78.           ESC[#;#H          move cursor
  79.           ESC[#;...;#m      set colors
  80.  
  81.         All ANSI sequences begin with ESC (ASCII code 27) and '[' (ASCII
  82.         code 91).  The # in the sequences refer to decimal numbers.  The
  83.         two numbers in the move cursor sequences are the row and column
  84.         location.  The numbers in the set colors sequence affect the
  85.         screen colors as follows:
  86.  
  87.            0  all attributes off, switch to normal color
  88.            1  bold on
  89.            4  (underscore, not supported)
  90.            5  blink on
  91.            7  (reverse video, not supported)
  92.            8  (concealed, not supported)
  93.           30  black foreground
  94.           31  red foreground
  95.           32  green foreground
  96.           33  yellow foreground (usually mapped to brown)
  97.           34  blue foreground
  98.           35  magenta foreground
  99.           36  cyan foreground
  100.           37  white foreground
  101.           40  black background
  102.           41  red background
  103.           42  green background
  104.           43  yellow background (usually mapped to brown)
  105.           44  blue background
  106.           45  magenta background
  107.           46  cyan background
  108.           47  white background
  109.  
  110.         Warp should work in all recognizable text modes.  If the /S
  111.         option is NOT specified, Warp will dynamically adjust the auto-
  112.         pause line count to the current number of displayed lines.  In
  113.         graphics modes, Warp passes all output to the BIOS.  Auto-pause
  114.         does not work in graphics modes.
  115.  
  116.         Though the ANSI sequence to clear the screen appears to work in
  117.  
  118.  
  119.  
  120.         all text modes, on my system, the DOS CLS command doesn't work
  121.         (it only clears the first 25 lines in the greater than 25 line
  122.         modes).  I think this is because DOS makes a direct call the to
  123.         BIOS to clear the screen, rather than using the CON device driv-
  124.         er.  If you have this problem, you could clear the screen by
  125.         displaying the clear screen ANSI sequence, for instance by ECHO-
  126.         ing ESC[2J.
  127.  
  128.         Compatibility considerations:
  129.  
  130.           * Warp expects the BIOS video routines to preserve the DI, SI,
  131.             and BP registers.  Some older ROM's (like the original IBM PC
  132.             ROM's) don't always do this.
  133.  
  134.           * Warp never waits for "vertical retrace" when displaying
  135.             characters, which may cause flickering on some CGA monitors.
  136.  
  137.           * Warp uses the older non-AT keyboard BIOS input routines, so
  138.             DOS will not be able to return extended keycodes (like F11
  139.             and F12).  This will probably effect few if any programs,
  140.             since most programs that use these codes use the BIOS for
  141.             input rather than DOS.
  142.  
  143.           * Warp positions the cursor by directly setting the location in
  144.             the video controller ports.  This may not work on nonstandard
  145.             video systems and may cause problems in some operating envi-
  146.             ronments.
  147.  
  148.  
  149.          ----------------end-of-author's-documentation---------------
  150.  
  151.                          Software Library Information:
  152.  
  153.                     This disk copy provided as a service of
  154.  
  155.                            Public (software) Library
  156.  
  157.          We are not the authors of this program, nor are we associated
  158.          with the author in any way other than as a distributor of the
  159.          program in accordance with the author's terms of distribution.
  160.  
  161.          Please direct shareware payments and specific questions about
  162.          this program to the author of the program, whose name appears
  163.          elsewhere in  this documentation. If you have trouble getting
  164.          in touch with the author,  we will do whatever we can to help
  165.          you with your questions. All programs have been tested and do
  166.          run.  To report problems,  please use the form that is in the
  167.          file PROBLEM.DOC on many of our disks or in other written for-
  168.          mat with screen printouts, if possible.  PsL cannot debug pro-
  169.          programs over the telephone, though we can answer questions.
  170.  
  171.          Disks in the PsL are updated  monthly,  so if you did not get
  172.          this disk directly from the PsL, you should be aware that the
  173.          files in this set may no longer be the current versions. Also,
  174.          if you got this disk from another vendor and are having prob-
  175.          lems,  be aware that  some files may have become corrupted or
  176.          lost by that vendor. Get a current, working disk from PsL.
  177.  
  178.          For a copy of the latest monthly software library newsletter
  179.          and a list of the 3,000+ disks in the library, call or write
  180.  
  181.                            Public (software) Library
  182.                                P.O.Box 35705 - F
  183.                             Houston, TX 77235-5705
  184.  
  185.                                 1-800-2424-PSL
  186.                              MC/Visa/AmEx/Discover
  187.  
  188.                           Outside of U.S. or in Texas
  189.                           or for general information,
  190.                               Call 1-713-524-6394
  191.  
  192.                           PsL also has an outstanding
  193.                           catalog for the Macintosh.
  194.  
  195.